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EDITORIAL 
By Peter BLAKE 


Once again this month, your editor was struck 
down with a nasty illness just as he was about to 
produce this newsletter for you. Some of the 
things that I promised that I would be doing will 
have to wait for another month. This illness means 
that not only will this issue of WireTAPS be thin 
again this month, it is also appearing a week late. 
If you do not get it before the-Toronto meeting of 
TAPS, please accept my apologies. As the old 
saying goes, it is better late than never. 


In addition, my Japanese classes have ended 
for the summer. This means that I will be able to 
get to the Toronto Chapter meetings of TAPS again. 


Perhaps, like Consumers' Reports, I should 
give some mention about "work in progress". There 
is a lot of it going on, and some of it would have 
been done by now had my illness not "laid me low". 


Firstly, you will not find the second part of 
my comparison of three word processors in this 
issue. The reason for that is that I have received 
upgrades for PaperClip from Batteries Included and 
The Writer's Tool from 0.S.S. 

The upgrade to PaperClip is version 1.2x which 
supports the extra memory in the 130XE.. I paid my 

$10 and sent away to beautiful downtown Richmond 
Hill for the upgrade. It came with a 13-page 
booklet explaining a new-feature in this version 
(Hanging Indents) and an index to the original 
PaperClip manual. It also contains documentation 


for three new utilities: -a printer configuration: 


file dump to let you know what options a particular 
printer driver has; an INDEX creating utility 
which given a list of words and a source document 
will create an index of the words in the document 
(what an excellent feature!!); and lastly a utility 
to change Atari charater sets to Epson FX character 
sets. This will only be of interest to people who 
own Epson FX and Epson-FX compatible printers. 

The upgrade to The Writer's Tool from 0.S.S. 
was version 2.25. It was free, and they even 
included an upgrade to BASIC XE with it. It came 
with a new QUICK REFERENCE CARD and a completely 
new manual. 0Q.S.S. no longer gives you the 
half-sized, three-ring binders, but the paper-bound 
manual is well printed and still very readable. It 
does not appear as if this version of The Writer's 
Tool has support for the extra memory in the 130XE, 
but then, it has always been my opinion that you 
are always far better off LINKing many small files 
rather than trying to edit one large unmanageable 
file. 

I want to give these new versions a thorough 
"work-out" before I continue with my comparison in 
order to be fair to all concerned. 


I also received an update (Version 1.09) to 
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the DVC/65 C compiler which corrected a bug I had 
found in the original. The upgrade was accompanied 
by a very nice chatty and informative letter, and 
the upgrade arrived from Eugene Oregan within 10 
days of the day I had sent my letter describing the 
bug! That's what I call service! I shall try to 
get working on the review of this excellent product 
which I consider to be the only realistic C 
compiler available for owners of 8-bit Ataris who 
want to get some hands-on experience with the C 
language. If you are interested in getting started 
with C before I get around to writing the review, 
please give me a call. 


I have also received Atari DOS 4.0. Those who 
were at the Scarborough meeting in March saw it 
demonstrated by Chris Thomson. Like Atari DOS 3.0, 
it provides for a one-way street for converting 
files from DOS 3.0 and DOS 2.0. It does support 
all three densities and double-sided. drives but 
until someone writes a utility to convert DOS 4.0 
files back to DOS 2.0 files, you would be best to 
follow Sean Keeley's advice and frame your DOS 4.0 
disk.on the wall beside your copy of DOS 3.0. 


Still with me? Well, I also’ received THE 
PRINT TOOL and WORD & SPELL MAGIC from ANTIC's APX 
CLASSICS. The PRINT TOOL was originally going to 
be published by 0.S.S.-but they never did. It is a 
translation for the Atari of the program RUNOFF 
which is a word processor which runs on DEC's 
PDP-11's. SPELL MAGIC is the spelling checker 
which Batteries Included recommends that you use 
with their PaperClip. One problem with both of 
these products is that the documentation comes in 
machine-readable form on the back of the disk and 
the integrated printing utility that comes with it 
and my non-standard dot-matrix printer seem to be 
irreconcilably incompatible. Sigh! 


Just in case you think that that is all, it is 
not. (I have been busy, haven't I.) I also 
received an upgrade to SpartaDOS: version 3.2 for 
US$ 10 which came with a-36-page manual. As 
claimed,.it does work with 0.S.S.'s BASIC XE. It 
also corrects a number of weaknesses in previous 
versions: record I/0 has been speeded up. 
Unfortunately, it also introduces some new and not 
very nice features: support for formatting Atari 
DOS 2.0 disks disappears when the BASIC XE with its 
extension is installed and SpartDOS 3.2 will not 
work with any O.S.S. Supercartridge but BASIC XE. 
That is definitely not nice! 


As you can see, there will be a lot to report 
on-in the months ahead. Regrettably, I cannot do 
it all alone. More regular contributors are 
required to keep this newsletter going. What can 
YOU do to help? 
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SCARBOROUGH NEWS 
By Graham THORLEY 


First, let me apologize for the absence of a 
Scarborough "NEWS" column in last month's WIRETAPS. 
As some of you are aware, my wife, my son and I 
were taking a well deserved (well I think we 
deserved it) rest in Mexico. Incidentally for all 
you Mexico haters out there that always say "I'll 
never go there. My stomach, and lower intestinal 
tract, couldn't take it! Did you get sick or get 
the runs???" No we didn't, nor have we in 3 
visits. In fact we have in all our time yet to run 
into anyone there who has had any more than a 
little upset tummy and generally for less than a 
day. It is great there, beautiful scenery and a 
climate you just can't beat. It almost never rains 
from December to July. The people are very 
friendly and courteous and despite our affluence 
and their poverty there is no chip-on-the-shoulder 
attitude that you get in Jamaica and many of the 
other Caribbean Islands. Oh well enough of the 
travel dialogue. 

March's meeting went very well with lots of 
dialogue from the members. Let's keep it up 
because YOU are what makes things tick, okay? We 
again had a number of new users out and spent about 
20 minutes at the beginning answering questions in 
the side room while the general group chatted 
informally. The time available for new users is 
obviously just not sufficient. I propose to offer 
an alternative to this and I have made a separate 
column which you can read elsewhere in this 
newsletter with a recommended solution. This 
month's software disk is one of the best yet with a 
spreadsheet being one of the highlights. Il 
guarantee you you will not find a better 
public-domain spreadsheet program so, if you 
haven't got it yet I recommend you make sure you 
get disk # 35. Also on the disk is a program by 
Bruce Fish from our Oshawa group which calculates 
your tax return for you. This is an excellent 
program and worked perfectly for my and my wife's 
return. Chris Thomson continued his excellent 
discussion on DOS demonstrating several DOS's 
including Dos 4.0 which was written for the never 
released 1450XLD machine. Thanks Chris. 


NEXT MEETING 

Pencil it on you calendar right away: April 
8th. AUCTION NIGHT. Come on out to Scarborough, a 
special invite to Toronto and Oshawa members, and 
sell what you don't want; buy what you need. This 
meeting will start at 7.00. rather than the usual 
7.50. the place, Cedar Ridge Craft Centre, 225 
Confederation Dr. Scarborough. Confederation Dr. 
runs off Scarborough Golf Club Road and is 2 
streets south of Lawrence Ave.E. If you need 
directions just call any of the Executive. See you 
there. 


AUCTION NIGHT 


We invite all TAPS' members to the next 
meeting of Scarborough TAPS which will include an 
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Auction night. So if you have anything you would 
like to sell i.e.: hardware, software (original 
only and Documentation must be included), books 
etc. bring it out. Reserve bids will be permitted 
provided the amount is approved by the Auction 
committee. That's Doug Barton and I, and our word 
is final. Come on out and bring lots of money, 
cheques will only be accepted if the seller agrees, 
and the club will not be responsible for non 
payment. 

This should be a fun night so come on out and 
be part of the action. Oh yes, non-Atari hardware 
will be permitted, but not non-Atari software. A 
word of caution: please ensure all goods sold are 
in working condition or if not, this must be 
declared. 


NEW ATARI USERS 


Are you a new user? Do you need Help? Or, if 
you are an old user and need help, Scarborough Taps 
will be sponsoring a special help night to give our 
members 2-3 hours of concentrated help. No 
software sales, demos or hoopla. There will be an 
introduction to the machine and how it works, how 
to use DOS, information on basic BASIC programming 
skills and a question and help period. The meeting 
will be open to all TAPS members but will be by 
advance registration and the number of participants 
will be limited so please register early. There 
will be no charge provided we do not have to rent a 
meeting room. If we do have to rent a room it will 
probably be about $1.00 per person. 

If you are interested, please contact me at 
284-2369. Be ready to provide the following: your 
skill level and when your preference to meet would 
be from the following choices: Monday, Tuesday, 
Wednesday, Thursday evenings 7.00 p.m. to 10.00 
pem.e Saturday morning 9.30 to 12.30. 

I would like to hear from any of our more 
experienced users who would like to help with this 
evening. All of those that ticked off "expert" 
under experience on our membership application can 
expect a phone call. 


ULTIMA IV: A BRIEF REVIEW 
By Sean KEELEY 


This was supposed to be another in my series 
on Atari LOGO, however, something happened which 
has consumed most of my spare time -- I bought the 
Ultima IV game about two weeks ago. 

I have steadfastly refused to buy any of the 
"dungeons and dragons" type games until now, 
primarily because I felt I was about 20 years too 
old for them; however several factors came together 
to cause me to break my rule: 

1. Ultima IV is one of the games with which Elec- 
tronic Arts has re-entered the Atari market, and 
since they've published so many great games in 
the past (M.U.L.E., Archon, Pinball Construction 
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Set, Seven Cities of Gold, etc.), I felt it 
would be good to do my bit in letting them know, 
via a cash outlay, that the Atari market is 
still here. 

2. The original Ultima was mentioned in the book 
"Hackers" as one of the early breakthroughs in 
microcomputer gaming. There is an incident 
described in the book where Steve Wozniak 
(designer of the Apple II) is thrilled to meet 
Richard Garriott (aka Lord British), creator of 
the game. 

3. Each of the games in the series has received 
uniformly excellent reviews throughout the 
years, and each new release goes instantly to 
the top of the best-seller charts, presumably 
bought by satisfied owners of the previous 
games. 

4. A review of Ultima IV I read stated that Lord 
British had "outdone himself" with this game. 


So, for all of the above reasons (complicated 
rationalizations?) I lashed out the admittedly 
steep price of ($89) for a copy. 

"Eighty-nine bucks for a game?" you're asking 
yourself -- "What do you get for so much money?" 
You get: 2 disks with all 4 sides used, a 56-page 
"History of Britannia", a 61-page "Book of Mystic 
Wisdom", a 5-page "player reference card" for the 
Atari version, a truly tacky looking cloth map of 
Britannia, and a small metal ankh (an Egyptian 
religious symbol, I believe). Also included is a 
note from Lord British explaining how, for a 
further $12.95 (US) you can get "The way of the 
Avatar: An Ultima IV Clue Book". 

When you boot the game, you can specify 
whether you have 1 disk drive or 2 (2 reduces the 
number of disk swaps necessary to almost zero), 
then you automatically see a few graphics screens 
of a pastoral scene, with text explaining how the 
books and the map materialize one day while you are 
out for a walk. At this point, the game tells you 
to read the "History of Britannia" book. If you, 
as I did, immediately press Return, the game says: 
"No really, read the book." After reading the 
book, you are shown a "Renaissance Fair" where you 
enter a fortune teller's wagon and are asked a 
series of questions, all of which are moral 
dilemmas. The game implies that the answers you 
give affect which of the eight major character 
types you will be in the game. 

The basic idea of the game is that you are on 
a quest to rid Britannia of evil. To do so 
requires you to explore all of the world of 
Britannia (there's a lot), fight many battles with 
a variety of creatures, solve puzzles, etc., etc. 
One of the key elements of the game is "conversing" 
with the hundreds of characters you meet in the 
various towns and villages -- you do this by giving 
one word topics (the standard ones are "Name", 
"Job" and "Health") and the character responds. By 
asking them about a key word or two which they 
mention, you can sometimes get more information. 
Sometimes, they know more, but you only find out 
from another character, who tells you, for example, 
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"Ask in the pub in Trinsic about the White Stone". 
Certain characters will, once you have enough 
experience, join you -- you can eventually end up 
with a party of 7 or 8 which you direct. 

The advertising for the game gives a suggested 
playing time of 100-200 hours, and based on my 
20-30 hours so far, I'd say that estimate may be 
reasonable. Of course, you can save your current 
status to disk and resume it later. It is also 
possible to copy the one "data disk" on which the 
game saves, so that two or more games can be 
ongoing at the same time (but not simultaneously, 
since only 1 of the 4 sides is copyable). 

One reviewer described Ultima III, the 
previous game in the series, as "a living 
tapestry", and although this is somewhat flowery, 
it is an apt description of the "Ultima experience" 
(By the way, Ultima IV is supposed to be "sixteen 


’ times larger than Ultima III".) As well as the 


country-side and the "dungeons" (I guess some 
traditions must be observed), each of the towns is 
many screens in size and must be explored. Various 
shops are found in these towns where you buy food, 
weapons, ingredients for magic spells (there are 26 
different spells possible), and so on. You can 
even capture a ship from some pirates and set off 
sailing! 

As you may have gathered, I am enjoying this 
game a great deal (it has passed the "makes you 
stay up too late" test with flying colours). I 
have, however, come across one bug -- there is one 
shop which, if you try to talk to the proprietor 
causes the game to crash ("lock up") completely. 
This bug, however, is only a minor annoyance since 
talking to the proprietor is not essential to the 
game, at least not so far. (for the information of 
those who may run into it, the shop is in the 
village of "Paws" and can be detected because it 
has no name.) Overall, if you want a very 
absorbing game, are willing to put the effort into 
it (it is, for example, absolutely necessary to 
keep notes as you play), and can justify the high 
price to yourself, Ultima IV is highly recommended. 


[Edward Skrecky is the brother of a TAPS' member. 
He wrote this article for another newsletter 
(sorry, Douglas did not mention which one). We are 
reprinting it here just to remind you what a good 
language Action! is. ] 


LIGHTS! CAMERA! ACTION! 
By Edward SKRECKY 


No, this is not the latest movie by George 
Lucas, it is a review of the Action! language by 
Optimized Systems Software (0SS). Action! is a 
true compiled language with incorporates some of 
the best features found in languages such as 
Pascal, C, Algol and Ada. It has many of the 
commands that are in Atari BASIC, but it runs up to 
115 times faster. Action! is made up of four 
different parts: the Action! language, the Action! 
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Editor, the Action! Monitor and the Action! 
Compiler. 

The Action! language is a structured language 
which is made up of components. Each component in 
turn is made up of single units which help to 
perform a single task such as printing a title page 
of a game on the screen. The components are 
normally called Procedures or Functions and the 
units are better known as commands such as 
PLOT(2,2). At the start of each program, all the 
variables used in the program must be declared to 
be a certain data type. Variables can also be 
declared at the start of Procedures of Functions. 
These variables are called local variables because 
they are only used in that procedure or Function. 
BYTE CTR=[4] is an example of a variable 
declaration which says that CIR is of type BYTE (a 
BYTE can hold a number from 1 to 255) and assigns 
to it the value 4. There are many commands in 
Action! which are similar to BASIC such as 
SOUND(2,10,3,4). Action! also has Pointers and 
many other features found in other languages such 
as Pascal. A pointer is an extended data type 
which can be made to point to a certain address in 
memory. Pointers are very useful to programmers 
because they make it easy to manipulate things such 
as screen memory. There are many other interesting 
features about the Action! language such as 
records, compiler directives and machine-language 
code blocks, but it would take too long to describe 
them in any great detail in the review. I have 
made a direct translation of a BASIC program from 
the BASIC Tips column in the January 1986 edition 
of the Garden City ACE Newsletter to help give a 
better understanding of what Action! looks like. 


BYTE X=[0], ;variable 
Y=[i01, 3declarations 
c=[0] 


PROC MAIN() 3main procedure 


GRAPHICS(11) 


DO sinfinite loop 
FOR X=0 TO 78 
DO 3FOR loop executed 79 times 
C==+1 3;same as c=c+1 
Ths C=127 a THENGE=B 
ial 3end of IF statement 
PLOT(X,Y) 


DRAWTO(78-X,Y) 
DRAWTO(78-x,191-Y) 
DRAWTO(X,191-Y) 


DRAWTO(X,Y) 
Y==+2 3same as Y=Y+2 
IF Y>191 THEN Y=0 
FI send of IF statement 
OD send of FOR DO-OD loop 
OD : 3;end of infinite loop 
RETURN 3end of Procedure MAIN 


In order to use a language you need an editor. 
Fortunately OSS has been thoughtful enough to 
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include an excellent editor. This editor is like a 
mini word processor. You can edit letters and even 
make changes to the source disk. This editor has 
many built-in functions. It is very easy to move 
blocks of code from one part of the program to 
another with only a few key strokes. Two entirely 
different programs can be edited at once with the 
split screen option. The editor also allows the 
contents of a disk to be viewed on the screen 
without the need of going to the DOS menu. 
Breaking and combining lines is also very easy to 
do. Of course, the editor has many of the standard 
saving/loading commands. Other useful features are 
the FIND and SUBSTITUTE commands. There are other 
useful features of the editor, but the ones already 
briefly described are the most interesting. 

The Monitor is another essential part of 
Action!. This is where the command is given to 
compile the Action! source code into Machine 
Language. The compiled code can be saved to disk, 
which allows the user to run the program without 
having to go to the trouble of compiling it again 
(compiling a program takes a certain amount of 
time). The Monitor has a useful option menu which 
allows the user to change certain options. The 
OPTION menu can be used to change the size of a 
line, turn off the bell, turn off the screen when 
using a disk drive (speeds up loading from disk), 
or to change many other things. One other 
interesting feature of the Monitor is that it can 
display the contents of one or a series of memory 
locations. 

Last but not least, there is the Action! 
compiler. The Compiler is very important because 
without it you would not be able to run any Action! 
code. All you would have is a very expensive 
mini-word processor. When a program is being 
compiled, the compiler changes the program line by 
line from readable words to 6502 instructions that 
the Central Processor (CPU) can understand and 
execute. If the source code has a "bug", the 
compiler will stop at the line that is in error and 
give an error message. Unfortunately, the error 
message is just a number so you have to search 
frantically for your copy of the Action! manual in 
order to find the meaning of the error in English. 
That fairly well summarizes what the compiler is 
doing. 

Action! is an excellent language and it is 
certainly more flexible that Atari BASIC. With 
execution speed approaching machine language, it 
has attracted many assembly-language programmers. 
The only major drawback to Action! is that it does 
not support floating-point numbers which are 
numbers with decimal-points in them. Fortunately 
there is a Programmer's Toolkit which provides some 
support for floating point in Action!, but it is 
all done in functions; there is no real integrated 
support for floating point. In all other respects, 
Action! is one of the best languages currently 
available for the Atari computer. If you are an 
avid programmer, or wish to become one, and you 
have $90 to spare, Action! is certainly a worthy 
addition to your software collection. 
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[This article was submitted many months ago. It 
was originally sent to me over a modem, and for 
some reason, all of the carriage returns were 
changed to spaces. Now, while I was able to 
recreate the body of the article, the many tables 
in it could not be fixed up. So I had to wait 
until I could get the article on disk. It should 
be added that the article is for the ADVANCED 
Assembly-language programmer. Ed. ] 


HIDDEN 6502 OPCODES 
By David Castell 


When learning machine language, one is usually 
more concerned with what commands the 6502 chip 
understands than how it understands them. But with 
a little more insight into how the 6502 chip 
interprets 8-bit opcodes to perform the proper 
function you'll find that the 6502 has many 
"hidden' opcodes. 

First, let's look at the ‘load register' 
commands: 


LDA - 101bbb01 
LDX - 101bbb10 
LDY - 101bbb00 


The bits represented by 'bbb' select the 
address mode, therefore, with the load function, 
there can be up to 8 address modes, but only a few 
functions (eg. LDA, STA, CMP, ADC) use 8 different 
ones. 

Accumulator related functions (STA, LDA, CMP, 
ADC, etc) have a different 'bit-address mode' 
relationship than X,Y register related functions 
(STX, LDY, INX, DEY, etc). The charts below show 
these relationships. 


AC XX 
goo - IND,X 000 - IMM 
001 - ZP 001 - ZP 


010 - reserved for one byte 
commands (INX, TAX, etc) 


010 - IMM or one byte 
commands (PLA,PHA) 


011 - ABS 011 - ABS 
100 - IND,Y 100 - reserved for 
branch commands 
101 - ZP,X FOS =PZPRY: or: ZP),.X 
110 - AB,Y 110 - reserved for TSX, 
TXS, SET & CLR commands 
111 - AB,X 111 - AB,Y or AB,X 


The first three bits identify the load command 
to the 6502 chip (although TAX, TAY, BCS, and TSX 
share the same first three bits) and the last two 
represent the register (X,Y,or A). By combining 
the LDA and the LDX commands together, the result 
would be 101bbb11. We have just discovered a new 
opcode which could be called LAX. LAX #$10 would 
load BOTH the accumulator and the X-register with 
the number $10. The 'bbb' values for the LAX 
command can be taken from the AC chart above. 

The STA,STX,STY bit patterns are identical to 
the load commands, except that the first three bits 
that identify the store command are 100 (although 
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TXA, TYA, TXS, BCC share the same first thre bits). 
Therefore combining the STA and STX would result in 
100bbb11. This new command could be called SAX and 
store the logical AND of the accumulator and the 
X-register into a memory location (according to the 
address mode). 

Although LAX and SAX are the most 
straightfoward hybrid opcodes, there are many more 
combinations ranging from the useful to the 
obscure. Below are a few of the more useful ones. 

By combining ROR (011bbb10) and ADC 
(011bbb01), we get an opcode that could be called 
RRA (011bbb11). The RRA opcode results in the 
following: 

ROR MEMORY 

ADC MEMORY (add with carry) 

(MEMORY - according to address mode) 

The combination of INC (111bb110) and SBC 
(111bbb01) results in an opcode which could be 
called INS (111bbb11). The INS opcode results in 
the following: 

INC MEMORY 

SBC MEMORY (subtract with carry) 


DEX (11001010) combines with CMP (110bbb01) to 
create an opcode which could be called AXS 
(11001011) that results in: 

(logical AND of AC and X-reg.) 

SBC #N (subtract with carry) 

TAX 
eg. BEFORE A=$B2, X=$F0, C=SET 

AXS #$10 
AFTER A=$B2, X=$A0, C=SET 


This opcode only works in the immediate mode and 
the accumulator is NOT altered by it. 


On top of hybrid opcodes, there are also about 
a dozen bytes which cause the 6502 chip to crash 
(eg. $02) and even the RESET key won't recover. 
There are some bytes (eg. $80) that cause the 6502 
chip to 'skip' the next byte and some bytes (eg. 
$0C) cause it to 'skip' the next word (two bytes). 


For example: 


LDA #$10 LDA #$10 

SKB ¢ SKIP BYTE SKW ;SKIP WORD 
BRK BRK 

STA $1000 BRK 


STA $1000 
BRK ;PROGRAM STOPS HERE 


BRK ;PROGRAM STOPS HERE 


It should be noted that you won't find any 
assemblers that support these hidden opcodes 
because there is no guarantee that these hidden 
opcodes will have the same function with different 
versions of the 6502 chip (although they do on 
most). Therefore, to use these new opcodes, you 
will have to use the .BYTE command in your 
assembler. 

The converse is also true, you won't find any 
disassemblers that will support these hidden 
opcodes. This can be a benefit in discouraging 
software pirates from disassembling and rewriting 
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parts of your code. 

Perhaps now you might be interested in 
discovering more hidden opcodes, but for now you 
can consult the chart below for the opcodes of the 
commands mentioned in this article. 


LAX SAX 

(Load A and X) (Store A & X) 
ABS - $AF ABS - $8F 
ZP - $A7 ze - $87 
IMM - $AB (4 ries - $97 
ZPX - $B7 ABS,Y - $98 
ABS,X  - $BF (IND),Y - $93 


ABS,Y - $BB 
(IND,X) - $A3 
(IND),Y - $B3 


RRA INS 
(Rotate Right then Add) (INcrement then Subtract) 
ABS - $6F ABS - $EF 
cee Gees ofa ABS,X - $FF 
ABS,Y - $7B ABS,Y - $FB 
ZP - $67 Ze - $E7 
ek a aTt Tp ary 
(IND,X) - $63 (IND,X) - $€3 
(IND),Y - $73 (IND),Y - $F3 
AXS (A & X_then Subtract) 
IMM - $CB 
SKB (SKip Byte) SKW (SKip Word) 
$80 $0C 

WANT ADS 


[Want Ads may be placed free of charge by any TAPS' 
member in good standing. ] 


WANTED: 
Disk Drive for Atari 800XL. Phone Karel ZDRCHANY: 
820-8581 (Evenings) 
974-4537 (until 4:30 p.m.) 


WANTED: 
Help with your newsletter WireTAPS. WireTAPS 
receives many newsletters from other groups. Help 
is needed to read these newsletters and decide 
which articles in them would be of interest to 
TAPS' members. If you think this interesting work 
might be for you, call the editor or talk to any 
member of the TAPS' Executive. 


SPECIAL NOTICE: The April 3rd meeting of the 
Toronto Chapter will NOT be an Auction Sale and 
Swap as was previously announced as the Scarborough 
Chapter will be having one this month. 
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CORRECTION 
By R. BLACKWELL 


There is an bug in the program ADDRESS which I 
wrote which appears on TAPS Software Library Disk 
#D032. 

The problem occurs when the program is run on 
a machine with less than 64K of memory. The 
problem--the search routine cannot locate the name 
you enter if there are too many names in the data 
list. It appears as though the routine used by 
BASIC uses just a little bit too much memory and an 
error occurs. Due to the extreme error checking in 
the program, the search falls through and you are 
asked to enter the name of the party you are 
searching for in full. However this will not work 
either, as the search routine for this is the same 
as for the first instance. 

I have come up with a change that sould clear 
the problem and allow the program to run properly 
on all machines with less than 64K memory. 

Look at lines 380, 740 and 1040. You will 
notice that with the exception of the GOTO's at the 
end of the line they are the same. The coding in 
these lines should be changed to read as follows: 

The old line looked something like this: 

TRAP 395:1F G$(LEN(G$) )=A$(LEN(A$)-4,LEN(A$)) THEN 
TRAP 40000:GOTO ??? 

Change the lines noted above to read as follows. 
Replace the question marks at the end of the GOTO's 
with the correct statement numbers. 

TRAP 395:IF G$=A$ then TRAP 40000:GOTO ??? 

This little change will allow the program to 
locate the names BUT only as they were entered. 
You will be unable to search for a name using the 
last 5 characters of the name as mentioned in the 
DOC file on the same disk. 


[The following article is a combination of two 
articles written by Bruce Smith of the Caltari 
Users' Group and is reprinted with permission. ] 


INPUT/OUTPUT ON THE ATARI 
INTRODUCTION 
By Bruce SMITH, now President of the 
CALTARI Users' Group in Calgary Alberta 


This is the first in a series of articles on 
the INPUT/OQUTPUT process on ATARI HOME COMPUTERS. 
I intend to cover the various levels in the 
hierarchy ~(there is. that word again) of 
programming. Much of it is in the operating system 
(0.S.) that is stored in the Read-Only Memory (ROM) 
of your computer. 1 learned much of this 
information by examining various utility programs 
in the public domain (such as disk editors) plus by 
reading the TECHNICAL REFERENCE NOTES from Atari 
(the club has a set). 


BRIEF DESCRIPTION 


Here is a brief description of the various 
components in Figure 1: 
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Figure 1 - The Hierarchy 


Peripheral Device - This is any of the various 
devices that you can connect to you Atari via the 
serial port. This includes disk drives, 
printers, modems, cassettes, 850 interfaces, etc. 


SIO (Serial Bus Input/Output Utility) - This is the 
ROM based code in the operating system which 
controls the flow of data up and down the 
interface cable, and is device-independent. 


Device Handler - This the code (some ROM based, 
some dynamically loaded) which is device specific 
(ise. there is one set of code for each device). 


CIO (Central Input/Output Utility) - This is the 
ROM based code which supplies a relatively 
device-independent interface between the user 
program and the various device handlers. The 
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user program makes a call to CIO, and CIO decides 
which driver to call. 


Basic Cartridge - Although not really a part of the 
true hierarchy, I include the cartridge to 
simplify the discussion. If you are working in 
machine language, then the Basic Cartridge (Basic 
ROM in XL's and XE's) is not involved. The 
cartridge converts the BASIC I/0 statements into 
calls to the CIO routines. 


Basic Program - The user program issues certain I/0 
statements (e.g. OPEN, CLOSE, GET), which pass 
control up the line. In machine language, the 
I/0 calls are made as direct calls to the CIO. 


PART II 
In this part, I will start to go into greater 
detail on the various levels of the hierarchy 
involved in the I/O process. 


PERIPHERAL DEVICES 

In the first part, I said I was going to 
discuss the various levels of programming involved 
in 1/0. It may seem strange to then mention 
hardware devices but if you examine the Atari 
peripherals closely, all but the cassette are 
intelligent devices. By that I mean they have a 
small microprocessor inside them allowing the main 
computer (your 400, 800, XL or XE) to talk to it at 
a higher level than many other computers. This 
simplifies the Operating System at the expense of 
making the peripherals more complex and hence more 
expensive. 

I do not pretend to understand the inner 
workings of the peripheral devices (I leave that to 
the electronics experts), but I do understand some 
of the principles of interfacing with them. 

If you take a look at how the peripherals are 
connected to your computer, most are attached to 
the serial port on the side or back of the machine. 
Some, such as certain MPP printer interfaces and 
modems, connect via the joystick port but most 
connect via the serial port. How is it then that 
when the CPU sends data down the serial cable this 
data does not end up being written to all devices? 
The reason is that there is a communications 
protocol which Atari defined for passing of data up 
and down the serial cable. Included in this 
protocol is a 1-byte device ID ($3x for disk where 
x is the drive number, $40 for the printer, $60 for 
the cassette and so on.) Only the device 
recognizing that ID responds and completes the data 
transfer. 

The command protocol varies from device to 
device. Part of the data stream sent to the device 
is the command. For a disk drive, the supported 
commands are $21 for FORMAT, $50 for WRITE without 
verify, $57 for WRITE with verify, $52 for READ and 
$53 for STATUS read. Drives that support true 
double density (including upgraded 1050's) also 
support two extra commands, $4E for READ CONFIG 
block and $4F for WRITE CONFIG block. The config 
block is 12 bytes of memory in the disk drive that 
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defines certain attributes of the drive (sides per 
disk, tracks per side, sectors per track, bytes per 
sector, density and more). By reading the config 
block, changing the appropriate bytes and writing 
it back you can change the density of a drive on 
the fly. Some of the other peripherals support 
many sophisticated commands, but rather than define 
them as direct commands as in disk drives, they are 
implemented as commands within the data stream sent 
out via a normal write command. Take a printer for 
example. Many have various options such as lines 
per inch, type font, line length, page length and 
so on. Generally these options are set by sending 
a command stream to the printer preceded by an 
escape character ($27). The Atari 1030 modem is 
similar. You send it various commands via an ESC 
sequence too. Through these commands you can tell 
it to dial a number, answer the phone, set what 
parity it uses and so on. The modem even contains 
a driver (more on drivers later) which can be 
loaded into memory by an appropriate SIO call. 

As you can see most Atari peripherals are 
intelligent and this eases the process of 
communicating with them. 


SERIAL BUS INPUT/OUTPUT UTILITY 

This set of code in the OS moves blocks of 
data to and from the appropriate device. The entry 
point of SIO is $£459. You cannot directly call it 
from BASIC. Instead you must create a small 
machine language string and reference it via a USR 
call. This means of defining your request to SIO 
is to fill in a DCB (Device Control Block) which 
starts at $0300 and is 12 bytes long. Its format 
is as follows: 


$0300 - DDEVIC 
$0301 - DUNIT 

$0302 - DCOMND 
$0303 - DSTATS 
$0304 - DBUFLO 
$0305 - DBUFHI 
$0306 - DTIMLO 
$0307 - unused 
$0308 - DBYTLO 
$0309 - DBYTHI 
$030A - DAUX1 

$030B - DAUX2 


And now for some details on the meaning of the 
above. 


DDEVIC - This is the device serial bus ID. Its 
possible values were discussed earlier under 
peripheral devices. In the case of disks it is 
not necessary to distinguish which drive is 
involved in this field. SIO will figure that out 
for you so just put in a $31 as though you wanted 
drive 1. 

DUNIT - This is the device number which really 
only has meaning for the disk drives. This 
number is merged with the DDEVIC to get the real 
device ID. 

DCOMND - This is the I0 command for the device. 
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Its possible values were also discussed above 
under peripheral devices. 

DSTATS - This byte serves two purposes. When 
listing the SIO call it contains a flag which 
says whether the command will result in receiving 
data ($40) or sending data ($80) or no data 
transfer at all ($00). After the I/0 is complete 
this field contains the status associated with 
the requested operation. This has many possible 
values. Some examples are: 138 ($8A) for device 
timeout, 143 ($8F) for checksum error and 144 
($90) for write to protected disk. 

DBUF xx - These two bytes (LO and HI) contain the 
address of the data buffer. They need only be 
set if data is to be transferred. In the case of 
a status request the status data is placed at a 
specific location elsewhere. 

DTIMLO - This byte specifies the device timeout 
value. SIO will wait this long before 
considering the device to be non-functional, 
returning a 138 status code. The unit of measure 
is 64/60ths of a second. 

DBYTxx - These two bytes (LO and HI) contain the 
number of bytes to transfer. 

DAUXx - These two bytes (1 and 2) contain device 
specific information. In the case of a disk 
drive they contain the sector number to be read 
or written. 


By placing the appropriate values in the above 
bytes and issuing a call to $£459 you can cause SIO 
to do the 1/0 directly. This is how disk sector 
editors are able to read specific sectors directly. 

SI0, when called, manipulates the above 
numbers and copies DDEVIC, DCOMND and DAUX1 and 2 
to CDEVIC, CCOMND and CAUX1 and 2 which are at 
$023A and $023D. These bytes are sent down the 
serial port by placing them in a special hardware 
register called SEROUT, which is referenced by 
storing into address $D20D. If the command sends 
data then the data will be sent out the same way. 
If the command receives data then the data is read 
from a different hardware register called SERIN, 
which is referenced by reading the same address. 
When the request is complete the appropriate status 
byte is placed in DSTATS and control is returned to 
the caller. 

This completes the second part in this series 
of articles. In the next article I will discuss 
DEVICE HANDLERS and CIO in more detail and, if 
there is room, give sample programs which 
demonstrate calling SIO directly from BASIC via USR 
calls to short machine language strings. 


WE GOT Two ! 
By Nick COLEMAN 


The Question/Suggestion Box at the Etobicoke 
meeting last month finally received some input. 
These, apart from being the first two suggestions, 
also pointed out a small deficiency in the BOX. It 
was not designed with any apparent method to remove 
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the suggestions, as all six sides were sealed. 
Pretty dumb, huh? I half expected one of the two 
notes to offer a solution to this unfortunate 
oversight. This, as was later revealed, did not 
turn out to be the case. 

Luckily I have relatively long fingers and was 
able to successfully remove both of them (the 
notes, not my fingers) intact. 

The first was a question about Mr. B.F's 
wayward newsletter and membership card, to which 
the answer is, "we appologize for the delay and 
promise that you will receive your new membership 
card along with your copy of WireTAPS this month." 
Your address on our database was incorrect and the 
Post Office returned your copy marked "NO SUCH POST 
OFR REE. 

The second was a suggestion for a "GAME/DISC 
Exchange". TAPS will be providing two 
opportunities to exhange hardware and software. 
The first will be at the SCARBOROUGH meeting on 
Tuesday, April 8th, in the form of an auction, and 
the second will be at the OSHAWA meeting held on 
the 2nd Saturday of June. We will announce it 
again in the May issue of WireTAPS. 

Please remember, that all software must be on 
the original disk and come with the original 
documentation, preferably with the packaging. TAPS 
does not condone or support Pirating of copyrighted 
software. 

If you have any other problems, questions or 
suggestions, drop them in the BOX, talk to one of 
the executive at the meetings or phone us at home. 
We are constantly striving to provide a better 
club. Let us know what we can do for you. 


[This is the first part of a series of articles 
which are intended to help new owners of 8-bit 
Atari computers to start programming. Ed. ] 


BASIC FOR BEGINNERS 
By Peter BLAKE 


So you have just bought a computer and now you 
want to know how to program it. As Atari computers 
come with BASIC (Beginner's All-purpose Symbolic 
Instruction Code), that is normally the first place 
that beginners begin. 

A lot of bad has been said about Atari BASIC, 
the fact is however, that for an 8-K (8096 
character) BASIC, it is amazingly good. One of the 
reasons that Atari BASIC can do so much in only 8K 
(Kilobytes) is that Atari BASIC uses a lot of the 
routines which are in the 14K (read "fourteen kay") 
Atari Operating System. 

Atari BASIC is in fact three separate things: 
a text-Editor, a syntax checker/tokenizer and a 
run-time interpreter. Let us pause just for a 
moment and look at each of these things separately 
before we get into our discussion of Atari BASIC. 

A Text-Editor is a piece of software which 
lets you enter and change words (i.e. "text"). 
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Atari BASIC's Text Editor is line-number oriented. 
That means that every line of "text" that you enter 
must be preceded by a line number. It is a 
primitive (that means it does not have very many 
features--this is also refered to sometimes as "not 
powerful") but full-screen editor. The concept of 
Full screen is hard to understand. The first 
editors that were made were "line" editors. They 
were written back in the days when the input-output 
device looked something like a typewriter. In fact 
many of the first real-time computers used teletype 
terminals as their input-output devices. 

A line editor is one which allows you to work 
on only one line at a time. A full screen editor 
is one which permits you to change any line which 
you see on the display screen. Atari BASIC has one 
quirk: you must hit <RETURN> while the cursor (the 
flashing white square on the screen) is on the line 
you have changed before the change "takes". The 
reason for this is that only when you hit <RETURN> 
is the line turned over to the syntax 
checker/tokenizer. 

It is now time to look at this syntax 
checker/tokenizer. "Syntax" comes from a Greek 
word meaning "to arrange in order". What that 
means is that the program checks to make sure that 
everything you have entered is in the correct 
order. A "token" is something which represents 
something else. In order to understand the 
difference between the BASIC commands "SAVE" and 
"LIST", it will be necessary to undertand a little 
bit about tokens. i 

Atari BASIC keeps the programs you key in in a 
"TOKENIZED" form. What that means is that 
internally the line you have keyed in as "PRINT 
SCORE" is not kept as the words "PRINT" and 
"SCORE". All of the words that you have keyed in 
are changed to TOKENS. There are two reasons for 
this: firstly, a TOKEN only takes up 1 byte (or 
character) and this means that the internal form of 
an Atari BASIC program will take less room than if 
the program were held as words. Secondly, it is 
faster to use tokens than to try and look up what 
to do with words like "SETCOLOR" or "POSITION" when 
you are "executing" the program. Even the word 
"SCORE" is held as a token. I will not go into 
details of how or why now. It is not important to 
know the how or why of tokens, but it is very 
important that you understand that tokens exist and 
that an Atari BASIC program is kept in memory as 
tokens. 

The last part of Atari BASIC is the run-time 
interpreter. This run-time interpreter translates 
tokens into the actions that you want the computer 
to perform. 

Before we continue, I would like to pause for 
a moment to describe the difference between "DIRECT 
MODE" and "DEFERRED MODE" commands. When you do 
not start a line with a line number, the syntax 
checker/tokenizer passes the line immediatedly to 
the run-time interpreter for processing. This is 
called "DIRECT MODE". As an example, if you were 
to enter 
PRINT 78.95 * 1.07 <RETURN> 
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the computer would respond with 

84.4765 

READY 

When you enter "LIST <RETURN>" 

the computer immediately "lists" the program which 
it has in memory, if any. 

When you enter a line with a line number at 
the start of it, the syntax checker/tokenizer keeps 
the line in memory but does not execute it right 
away. This is called "DEFERRED MODE". 

Well that has been a very long winded 
explanation that has not really explained one bit 
of Atari BASIC to you. Let's look at how we can 
categorize Atari BASIC instructions. 

Atari BASIC instructions are divided into the 
following groups: 

1) PROGRAM DEVELOPMENT COMMANDS 
2) THE ASSIGN STATEMENT (LET) 
3) PROGRAM CONTROL STATEMENTS 
4) INPUT/OUTPUT (1/0) COMMANDS 
5) MEMORY MANAGEMENT COMMANDS 
6) FUNCTIONS (which are subdivided into) 
6.1) Arithmetic Functions 
6.2) Trigonometric Functions 
6.3) Special-Purpose Functions 
6.4) String Functions 
6.6) Graphics & Screen Functions 
6.7) Sound & Game Controller Functions 

But I see that the room left in this month's 
newsletter is quickly running out, so you shall 
have to wait until next month to find out about the 
Program Development Commands. 


THE Atari Programmers' Society 
P.O. Box 6287 Station "A" 
TORONTO ON MSW 1P7 


TAPS OSHAWA 


Your Executive is attempting to restructure 
our meeting format to reflect the needs and 
interests of the general membership. At the last 
meeting Howard Creuse presented his plans to 
accomplish this and to this end, we started a 
management committee (consisting of 5 interested 
members to date). This is your club--tell us what 
you want to see at meetings. We need your active 
support, and your input. Whether you are a 
new-comer, or a novice, (or both), an old-timer, or 
a pro--your participation is invaluable. 

Our next meeting will be Saturday April 12th 
at 10:29 at the Whitby Public Library. Same old 
place, same old time, but that's where the 
similarity ends (the last few meetings have been 
-.-. well ... subdued). This month, there's 
something for everyone so come on out and 
participate. There'll be demos of a 256K upgrade 
for your 800XL; Atari BASIC versus BASIC XL ("How 
come my BASIC doesn't look like everybody 
else's?"); DOS (what it is; why do I need it; why 
are there so many different ones; how are they 
different: DOS 2.0, DOS 2.5, SPARTADOS, TOPDOS, 
MACHDOS, ...)3 QUIZ QUESTION OF THE MONTH; Library 
disk of the month; and a Question and Answer 
session; and lots of opportunity to talk, 
socialize, discuss problems, ask dumb questions, 
and get involved in your club. Following the 


regular portion of the meeting there will be a demo 
See you there. 


of several(?) 520ST's. 


